home *** CD-ROM | disk | FTP | other *** search
/ Night Owl 9 / Night Owl CD-ROM (NOPV9) (Night Owl Publisher) (1993).ISO / 005a / twast11.zip / TWASTMAC.DOC < prev    next >
Text File  |  1993-02-06  |  18KB  |  540 lines
  1.  
  2.                         ▄                             ▄
  3.          ▀▀█▀▀  █▀▀▄  █▀▀▀█  █▀▀▄  █▀▀▀  █▄     ▄█  █▀▀▀█  █▀▀▄  █▀▀▀
  4.            █    █▄▄▀  █▄▄▄█  █  █  █▀▀    █ ▄█▄ █   █▄▄▄█  █▄▄▀  ▀▀▀█
  5.            █    █  █ ▄█   █▄ █▄▄▀  █▄▄▄   █▄█ █▄█  ▄█   █▄ █  █  ▄▄▄█
  6.       ▄                                               ▄
  7.    ███████  ███████  ███████  ██  ███████  ██████  ███████  ██    ██  ██████
  8.    ██   ██  ██       ██       ██  ██         ██    ██   ██  ███▄  ██    ██
  9.    ███████  ███████  ███████  ██  ███████    ██    ███████  ██▀██▄██    ██
  10.    ██   ██       ██       ██  ██       ██    ██    ██   ██  ██  ▀███    ██
  11.   ███   ███ ███████  ███████  ██  ███████    ██   ███   ███ ██    ██    ██
  12.                                ▄
  13.                    █▀█ █▀█   █▀▀▀█   █▀▀█  █▀▀▄  █▀▀█  █▀▀▀
  14.                    █ ▀█▀ █   █▄▄▄█   █     █▄▄▀  █  █  ▀▀▀█
  15.                   █▀     ▀█ ▄█   █▄  █▄▄█  █  █  █▄▄█  ▄▄▄█
  16.  
  17.  
  18.                                  Version 1.1
  19.  
  20.                                 for use with
  21.                           Trade Wars 2002 Assistant
  22.                              contributed by many
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62. ╔════════════════════════════════════════════════════════════════════════════╗
  63. ║                             Table of Contents                              ║
  64. ╚════════════════════════════════════════════════════════════════════════════╝
  65.  
  66.  
  67.   1   Introduction  . . . . . . . . . . . . . . . . . . . . . . . . . . .   3
  68.  
  69.        1.1   Disclaimer . . . . . . . . . . . . . . . . . . . . . . . . .   3
  70.  
  71.  
  72.   2    General Information  . . . . . . . . . . . . . . . . . . . . . . .   3
  73.  
  74.  
  75.   3    Qmodem . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   4
  76.  
  77.  
  78.   4    Telix  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   5
  79.  
  80.  
  81.   5    Procomm Plus . . . . . . . . . . . . . . . . . . . . . . . . . . .   7
  82.  
  83.  
  84.   6    Commo  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   9
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.                                    Page 2
  120.  
  121.  
  122. ╔════════════════════════════════════════════════════════════════════════════╗
  123. ║ Section  1                    Introduction                                 ║
  124. ╚════════════════════════════════════════════════════════════════════════════╝
  125.  
  126.     People have contributed these macros to help users capture the reports
  127.   during a Trade Wars session.  You are not required to use them, you may
  128.   capture the information in the manner that best suits you.  The macros are
  129.   a bonus and are not considered part of the TWASSIST software.
  130.  
  131.     These macros are provided as freeware.  You may modify them for your own
  132.   use.  You may distribute modified macros as a separate package but you may
  133.   not distribute modified macros as part of any TWASSIST package.
  134.  
  135.  
  136. ░▒▓█  1.1  █▓▒░  Disclaimer
  137.  
  138.     The macros are provided AS IS.  Neither Sasquatch Software nor the macro
  139.   authors provide any warranty, either expressed or implied, with respect to
  140.   the software or documentation, including but not limited to their quality,
  141.   performance, merchantability, or fitness for a particular purpose.  In no
  142.   event will Sasquatch Software or the author be liable for direct, indirect,
  143.   special, incidental, or consequential damages arising out of the use,
  144.   misuse, or inability to use the software or documentation, even if advised
  145.   of the possibility of such damages.
  146.  
  147.  
  148.  
  149.  
  150.  
  151. ╔════════════════════════════════════════════════════════════════════════════╗
  152. ║ Section  2                 General Information                             ║
  153. ╚════════════════════════════════════════════════════════════════════════════╝
  154.  
  155.  
  156.     The section title is the name of the communications program the macro is
  157.   for.  Each section will include the name of the macro file, the author of
  158.   the macro, and information on how to use the macro.  All of the macros are
  159.   in the TWASTMAC.ZIP file.  Find the macro file you want to use, as named in
  160.   the section for your communications program, and extract it from the file.
  161.  
  162.     Typically the macros were developed to be executed from the main Trade
  163.   Wars menu.  Each section will identify any special requirements.
  164.  
  165.   WARNING:  These macros will invoke computer interrogation mode in the game
  166.             and do a port report.  There is a bug in v1.03 of Trade Wars 2002
  167.             where it will kick you out of the game if you have not ported or
  168.             statused a port before doing this.  To prevent this, either port
  169.             or get a port status from the computer.  You can do this with
  170.             any port except a class 0.
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.                                    Page 3
  180.  
  181.  
  182. ╔════════════════════════════════════════════════════════════════════════════╗
  183. ║ Section  3                       Qmodem                                    ║
  184. ╚════════════════════════════════════════════════════════════════════════════╝
  185.  
  186.   File:  TWASSIST.SCR
  187.     By:  Albin Gersich
  188.   Date:  02/06/93
  189.  
  190.     Gathering all the data that TWASSIST can use is as simple as pressing a
  191.   key with this script.  The source code is included for those who want to
  192.   incorporate this into their own scripts, or you can customize this one.
  193.  
  194.     This script provides a menu of options, allowing you to capture all the
  195.   reports used by TWASSIST or just some of them.  Maybe you don't have much
  196.   time left and you only want to get the CIM reports, or you have just started
  197.   your session and want to get updates on fighter and mine deployment.  Here
  198.   is the menu:
  199.  
  200.         (T)W2002 Assistant
  201.  
  202.         (A)ll reports
  203.         (C)IM sector and port reports
  204.         (P)ort report
  205.         (F)ighters, mines, and avoids
  206.  
  207.         E(x)it script
  208.  
  209.         Your selection?
  210.  
  211.  
  212.     The option that runs TWASSIST has two variables that may need changing
  213.   depending on where files are located on your system.  One variable specifies
  214.   the location of the TWASSIST executable, the default is c:\tw\twassist.exe.
  215.   The other variable is the directory where your data files are stored, the
  216.   default is c:\tw.  This directory variable is used to change your current
  217.   directory to that location before running TWASSIST allowing you to enter
  218.   your database name without the full path.
  219.  
  220.   QModem v4.3 was used for this script.
  221.  
  222.   Example key assignment (CTRL-F10 for example):
  223.     - Press ALT-J in QModem
  224.     - Press '3' to assign a CTRL key
  225.     - Move cursor to key field (example:  CTRL-F10 field)
  226.     - Type @SCRIPT TWASSIST
  227.     - Press F10 to save
  228.     - Press ESC to exit
  229.  
  230.   QModem Usage:
  231.     - Start your screen capture by pressing CTRL-HOME
  232.     - Make sure you are at the main command prompt in Trade Wars.
  233.     - Execute the TWASSIST.SCR file by pressing the key assigned to it.
  234.     - Select the macro option from the menu shown.
  235.     - When your screen stops you can press CTRL-HOME to close the screen
  236.       capture.
  237.  
  238.  
  239.                                    Page 4
  240.  
  241.  
  242. ╔════════════════════════════════════════════════════════════════════════════╗
  243. ║ Section  4                       Telix                                     ║
  244. ╚════════════════════════════════════════════════════════════════════════════╝
  245.  
  246.   File:  TWASSIST.SLT   (source code)
  247.   File:  TWASSIST.SLC   (compiled code)
  248.     By:  Dan Roseen
  249.   Date:  02/05/93 - v1.2
  250.  
  251.     Gathering all the data that TWASSIST can use is as simple as pressing a
  252.   key with this script.  I've included the source code for those who want to
  253.   incorporate this into their own scripts, or you can customize this one.
  254.     
  255.     This script provides the following menu of options, allowing you to 
  256.   capture all the reports used by TWASSIST or just some of them.  Maybe you 
  257.   don't have much time left and you just want the CIM reports, or you have 
  258.   just started your session and want to get updates on deployed fighters 
  259.   and mines.
  260.                    ╒═ 02/05/93 - D. Roseen - v1.2 ═╕
  261.                    │                               │
  262.                    │ (T)W2002 Assistant            │
  263.                    │                               │
  264.                    │ (A)ll reports                 │
  265.                    │ (C)IM warp and port reports   │
  266.                    │ (P)ort report                 │
  267.                    │ (F)ighters, mines, and avoids │
  268.                    │                               │
  269.                    │ E(x)it script                 │
  270.                    │                               │
  271.                    │ Your selection?               │
  272.                    │                               │
  273.                    ╘═══════════════════════════════╛
  274.     
  275.     *** NOTE! ***  If your TWASSIST directory is not C:\TW you you MUST
  276.   change the default TWASSIST directory in the Telix script source code for 
  277.   proper operation!  This is the directory which contains your TW Assistant
  278.   executable and data files.  You can change it with a simple ASCII text 
  279.   editor and recompile the source code by running Telix's CS.EXE program 
  280.   (e.g. CS TWASSIST) and CS.EXE will create a new TWASSIST.SLC file from your 
  281.   revised TWASSIST.SLT file.  The directory variable is used to change your 
  282.   current directory to that location before running TWASSIST.  This makes it 
  283.   easier to enter the name of the database at the TWASSIST prompt.  You only 
  284.   have to enter the name instead of the full path.
  285.   
  286.   Telix v3.15 was used for this script.
  287.  
  288.   Example key assignment (CTRL-F10 for example):
  289.     - Press ALT-K in Telix
  290.     - Select default of "Regular" or press 'R'
  291.     - Select "Edit" or press 'E'
  292.     - Press the key you want it assigned to (example:  CTRL-F10)
  293.     - Type @TWASSIST
  294.     - Press the space bar since you don't want to assign any more keys.
  295.     - Select "Save" or press 'S' and save to a key file.
  296.     - Select "Exit" or press 'E'
  297.  
  298.  
  299.                                    Page 5
  300.  
  301.  
  302.                                4  Telix  (contd)
  303.  
  304.  
  305.   Telix Usage:
  306.     - Start your screen capture by pressing ALT-L
  307.     - Make sure you are at the main command prompt in Trade Wars.
  308.     - Execute the TWASSIST.SLC file by pressing the key assigned to it.  You
  309.       will see the menu and then make your selection.
  310.     - When your screen stops you can press ALT-L and close the screen capture.
  311.  
  312.  
  313.  
  314.  
  315.  
  316.  
  317.  
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  
  324.  
  325.  
  326.  
  327.  
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334.  
  335.  
  336.  
  337.  
  338.  
  339.  
  340.  
  341.  
  342.  
  343.  
  344.  
  345.  
  346.  
  347.  
  348.  
  349.  
  350.  
  351.  
  352.  
  353.  
  354.  
  355.  
  356.  
  357.  
  358.  
  359.                                    Page 6
  360.  
  361.  
  362. ╔════════════════════════════════════════════════════════════════════════════╗
  363. ║ Section  5                     Procomm Plus                                ║
  364. ╚════════════════════════════════════════════════════════════════════════════╝
  365.  
  366.   File:  TWASSIST.ASP
  367.     By:  Jason Jiggins
  368.   Date:  02/06/93
  369.  
  370.     This script is for use with the Trade Wars Assistant by Albin Gersich,
  371.   but the information it obtains can be used with a number of Trade Wars
  372.   utilities.  It was compiled and tested with Procomm Plus for Dos, version
  373.   2.01.  It may or may not be compatible with Procomm Plus for Windows.
  374.  
  375.     The script captures your CIM port and sector reports, fighter, mines,
  376.   avoids, and the game status in a variety of ways.  You can also use it to
  377.   access TW Assistant easily while online.  The macro was designed so that
  378.   you don't have to capture a complete data file all the time.  Often times,
  379.   you only want to capture the latest port information, or update your fighter
  380.   info in the database for transwarp calculations while online.  I wanted to
  381.   do these things quickly and efficiently, so I took the heart of Casey
  382.   Stemp's macro and greatly expanded on it.
  383.  
  384.     Everything is accessed through the main menu.  When you run the macro, the
  385.   menu will be displayed with the items and their hot-keys.  To access an
  386.   item, just press the appropriate hotkey.  Each menu item is explained below:
  387.  
  388.     "<A>ssistant" - This takes you directly to Trade Wars Assistant.  It skips
  389.   the checking for old capture files so they remain intact.  Note too, that it
  390.   calls the program with no parameters, so you can enter the database name if
  391.   you keep multiple databases.  If not, you can edit the macro to load a
  392.   particular database each time.
  393.  
  394.     "<B>oth F,M,A, & Port rep." - This creates a capture file with just the
  395.   CIM port report, fighters, mines, and avoids.  Read the next two sections
  396.   for more information.  Note too that this, like all the capturing menu
  397.   items, checks for old capture files first and erases them if found.
  398.  
  399.     "<P>ort report" - This accesses the CIM (Computer Interrogation Mode) of
  400.   your Cray XXV (ship computer) and captures the newest port information.
  401.  
  402.     "<F>ighters, mines, avoids" - This produces a capture file of the three
  403.   things listed.  Great for updating your database for online calculations
  404.   after deploying a lot of new fighters or mines (or after those fighters or
  405.   mines have been destroyed).
  406.  
  407.     "<C>omplete capture file" - This captures everything if you want to create
  408.   a new database, or update all your database information.  This is the only
  409.   menu item that will capture your CIM sector information and your game
  410.   status.  Since I explore my universe completely and very quickly (in two
  411.   days), I never need to update my sector info.  And I rarely bother updating
  412.   my game status information, so I put them here.
  413.  
  414.  
  415.  
  416.  
  417.  
  418.  
  419.                                    Page 7
  420.  
  421.  
  422.                            5   Procomm Plus  (contd)
  423.  
  424.  
  425.   Some notes:
  426.  
  427.   - I recommend setting up the macro as a Meta Key (an Alt-Key combination)
  428.     for quick and smooth access.  You can put the script file in any
  429.     directory, just specify the correct path to the macro in the Meta Key
  430.     definition.  The script will automatically save your current directory,
  431.     switch to the directory which contains your Trade Wars Assistant files,
  432.     and switch back to the original directory when finished.
  433.  
  434.   - I designed the macro to use the same WAITFOR and TRANSMIT commands to
  435.     reduce size, giving the macro a kind of "spaghetti" look.  It runs very
  436.     smoothly, however.
  437.  
  438.   - When checking for the hotkey presses, it looks for the escape key for
  439.     quick exiting in case you access the macro accidentally (enter the wrong
  440.     Alt-Key combination).  When this is done, it skips the checking for old
  441.     capture file to maintain capture file integrity.
  442.  
  443.   - When you select a menu item, it displays the the macro name in bold
  444.     letters on the screen and pauses for 750 milliseconds (3/4ths of a
  445.     second), then continues with the macro.
  446.  
  447.   - Make sure you run the macro from the main Trade Wars command line, and
  448.     not from the Computer command line, for proper operation.
  449.  
  450.     The script is easily customizable as well.  Especially with the Aspect
  451.   Script Language reference.  You can change colors, move menu items around,
  452.   change the item titles and hotkeys, and edit the directory information, the
  453.   pause time, or capture file name.  I'll indicate sections where you might
  454.   want to customize.  Any necessary or important customization sections will
  455.   be indicated by "***" followed by all capitals.
  456.  
  457.     *** NOTE! ***  There is one area you MUST change for proper operation!
  458.   This is the directory which contains your TW Assistant executable and data
  459.   files.  They should BOTH be in the same directory.  I put the macro in a
  460.   separate directory, but you can keep everything in one directory if you
  461.   like.
  462.  
  463.  
  464.  
  465.  
  466.  
  467.  
  468.  
  469.  
  470.  
  471.  
  472.  
  473.  
  474.  
  475.  
  476.  
  477.  
  478.  
  479.                                    Page 8
  480.  
  481.  
  482. ╔════════════════════════════════════════════════════════════════════════════╗
  483. ║ Section  6                        Commo                                    ║
  484. ╚════════════════════════════════════════════════════════════════════════════╝
  485.  
  486.   File:  TWASSIST.MAC
  487.     By:  Casey Stemp
  488.   Date:  02/06/93
  489.  
  490.     This is a COMMO macro, made in the COMMO macro language.  Place the line
  491.   beginning with "(:alv)"inside COMMO.MAC.  (Substitute the "(" and the ")"
  492.   for their respective curly braces)
  493.  
  494.     (:alv)(macl twassist.mac,twassist)()
  495.  
  496.   Now, by pressing ALT-V it will load up this file (TWASSIST.MAC) and run the
  497.   macro.  Please consult MACRO.DOC for more information about changing the
  498.   ALT-KEY combinations that execute the macro.  Everything that you may wish
  499.   to personalize is on a line by itself with little stars (*) before it.
  500.  
  501.     This macro will pop up a message stating that the macro is running, and
  502.   then proceed to delete your capture file from the last run (if it exists).
  503.   This is so you don't get a giant unmanageable capture file.  Please change
  504.   the path, and/or the file names to what you have set up.  There are only
  505.   three lines to change!
  506.  
  507.     The macro will then open a capture file, and collect information on
  508.   your deployed fighters, deployed mines, and the game status.  It will then
  509.   autommaticaly get you into the computer menu, and collect your avoids, it
  510.   will then acces the C.I.M. and get the current warps, and port reports for
  511.   you.  After that it will take you back to the main Trade Wars menu, where
  512.   the macro will terminate.  You may stop the macro at any time by pressing
  513.   ESCAPE.  Then you will need to press ALT-R to reload the COMMO.MAC file.
  514.   If the macro is allowed to run until natural termination, it will
  515.   automaticaly reload the COMMO.MAC.
  516.  
  517.  
  518.  
  519.  
  520.  
  521.  
  522.  
  523.  
  524.  
  525.  
  526.  
  527.  
  528.  
  529.  
  530.  
  531.  
  532.  
  533.  
  534.  
  535.  
  536.  
  537.  
  538.  
  539.                                    Page 9
  540.